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ABSTRACT 

This paper describes the emulation of a Nova 40A7A Cartridge Disk System 
on the Stanford Emmy, The Cartridge Disk Emulator (CDE) serves as a peripheral 
to a Nova 3 processor emulator, also installed on the Emmy. With a disk system, 
DG disk based operating systems can be installed, al lowing a wi de range of 
programs to be studied. 

The Cartridge Disk Emulator uses the Mini UNIX system to provide I/O services 
and manage the physical disk resources. CDE transforms Nova I/O commands into 
UNIX file access requests and processes all status resulting from those requests. 

All other peripheral emulators currently installed on Novaem are small simple 
programs that may easily be understood from the program listing. CDE, however, is 
in itself a very complex program. It is comparable in complexity and code space, 
to the entire Nova Code Emulation Program. Therefore, a document dedicated to 
its description is required. 

Appendix A of this document discusses how to add a new peripheral to NovaemU 
and NovaemCD. 



The work described herein was supported in part by the Department of Energy 
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1.0 INTRODUCTION 

This paper describes the emulation of a Nova 4047A car tc idge Disk 
System on the Stanford Emmy. The cartridge Disk Emulator (CDE) secves 
as a peripheral to a Nova 3 processor emulator, also installed on the 
Emmy. With a disk system, DG disk based operating systems can be 
installed, allowing a wide range of programs to be studied. 

The cartridge Disk Emulator uses the Mini UNIX system to provide I/O 
services and manage the physical disk resources. CDE transforms Nova 
I/O commands into UNIX file access requests and processes all status 
resulting from those requests. 

All other peripheral emulators currently installed on Novaem are small 
simple programs that may easily be understood from the program 
listing. CDE, however, is in itself a very complex program. It is 
comparable in complexity and code space, to the entire Nova Code 
Emulation Program. Therefore, a document dedicated to its description 
is required. 

Appendix A of this document discusses how to add a new peripheral to 
NovaemU and NovaemCD. 



2.0 FUNCTIONAL DESCRIPTION OF CDE 

CDE attempts a class A emulation of the DG 4047A cartridge disk 
system. Obviously, complete emulation of a disk system is impossible 
especially when dealing with timing and error processing functions. 
It is hoped, however, that CDE presents an interface enough like a 
real 4047A so that Disk operating system software will run without 
modification. However , there are functional differences and these will 
be discussed. 

2.1 Capacity 

CDE can support up to four drives with 1,247,232 word of storage pec 
drive. Each Drive coc responds to a UNIX device file as shown. 

Drive UNIX Device # 270 

1 271 

2 272 

3 273 

The ready status of each dr ive is maintained by UNIX via the device 
ready and Device not ready commands. In UNIX, a device ready command 
is issued to CDE whenever the user assigns a file to the device 
number , and a device not ceady command generated when the file is 
closed. When CDE is first loaded, it presets Drive ceady and Drives 
1-3 not ceady. The ceady bits ace available to Nova code via RegA 
status and thus can be (and probably is) used by the Nova disk dc ivec 
to detecmine capacity of the system. 

2.2 Functions 

The DIA-DOC instructions ace executed as described in the Peciphecals 
Refecence Manual and need no fucthec discussion hece. These 
instcuct ions, with special function code zeco, do not cause any 
CDE-UNIX communication. They only update the A-C cegistecs. 

The special functions, START, CLEAR, and IOPULSE originate all I/O and 
accocdingly affect CDE-UNIX communication. 

START - (Read/Wcite Command). Using the sectoc and side infocmation 
in RegC, and the cylindec number fcom the specified dc ive status wocd, 
a UNIX byte addcess is focmed. This addcess calculation algorithm 
assumes that the ficst wocd on sectoc zeco, side zeco, cylindec zeco 
coccesponds to the ficst wocd in the UNIX device file assigned to the 
dc ive. 

Next, a seek command is issued on the dc ive specified in RegC followed 
by on oc two cead/wcite commands. Two commands ace issued if the 
cead/wcite buffec in Nova memocy ovec flows; that is, if it wcaps 
acound thcough zeco. The ficst command pcocesses the buffec fcom the 
stacting addcess to 77777 and the second pcocesses the cemaindec of 
the buffec stacting at Nova addcess 0. This is required to emulate 
the module 32K memocy addcess counter in the 4047A. 



A read command is issued if the command field in BegA =2, a write 
command if it =3, and a NOP results if it =0, or 1 (Note, the 
Peripherals Reference Manual does not discuss the response of the 
4047A when a Nova Start Function is executed and the command field 
specifies a seek) . 

All Status is updated as defined foe the 4047A. 

When the command completes, the drive's Status word and Registers A-C 
are updated to their final values as specified. Notice that the MAR 
(RegB) and the sector count fields are updated in one step at 
completion (In a real 4047 these fields are updated continuously 
during the operation). A Nova interrupt is issued as specified. 

IOPULSE - (Seek Command) . Using the cylinder and command fields in 
RegA, a UNIX byte address is calculated. If the command field does 
not specif iy a seek or recalibrate command, then the IQPLSE is treated 
as a NOP. Otherwise, a seek command is issued on the drive specified 
in RegC. The drive ready flag is cleared, the seeking flag set, and 
the cylinder field in the device status word updated from the 
equivalent field in RegA. 

At completion of the operation, the drive is returned to ready state 
and the seeking flag cleared. A Nova interrupt is issued as 
specified. 

Note: The IOPULSE function could have been handled as a NOP 
since a UNIX seek command is required prior to any 
read/write operation. It was implemented, however, to 
achieve timing characteristics at least similar to a real 
disk system. Since the UNIX disk devices map onto a real 
disk drive, then real time seek control might improve Nova 
operating system performance, 

CLEAR - (reset all CDE I/O). All disk operations are aborted using 
the UNIX abort (device) command. When UNIX has acknowledged the abort, 
CDE can safely initialize the drive status words and clear any Nova 
interrupt. 

2.3 Status 

The real 4047A maintains a 7 bit status field for each drive. In 
addition, the current cylinder is implicitly known by the position of 
the head. CDE keeps equivalent information on a drive in the status 
vector, CDS, (see Section 3, figure 3-1). 

As stated earlier, the drive's cylinder number is preset to the value 
specified in the last DOA instruction when a seek command (IOPULSE) is 
performed. The cylinder number, unlike most other variables, is not 
cleared during a reset command. It can only be modified by the 
IOPULSE special function. 

The 7 bit status field is now defined for CDE. The names of the 
indiviual bits are consistent with DG terminology. 



Drive Ready (bit 9). At load time this bit is pceset to 1 on drive 
zero and to foe drives 1-3, Thereafter it is" cleared when: 

1) A device not ready UNIX command specifying this drive is 
received. 

2) A Nova seek command (IOPLSE) is successfully issued on 
this drive. 

The bit is set (drive goes ready) when: 

1) A device ready UNIX command specifying this drive is 
received. 

2) A Nova seek command completes foe any reason (successful 
or not) . 

CDE will not issue any command except abort (device) to UNIX on a drive 
that is not ready. 

Seek Error (bit 10). A seek error occurs when an out of bounds 
cylinder number is specified in a Nova seek command, or when UNIX 
returns an error on a seek finish. 

End Error (bit 11). The error occurs when the sector count specifies 
that a read/write operation should continue beyond the last surface of 
the disk cartridge. This error is actually detected by CDE when the 
Nova read/write command is issued. CDE records the eeroc, modifies 
the calculated buffer length count, and then issues the correct 
command to UNIX, Thus, the portion of the buffer on the valid 
cylinder is processed as in the real 4047. When the cead/write finish 
command is received, CDE sets the end error in the Drive's Status 
word. 

The end error is also set if the sector number is out of bounds when 
the command is issued. In this case, CDE aborts the instruction not 
initiating any UNIX I/O. In a real 4047, an illegal sector causes an 
infinite sector search that can be cleared only by an IORST. It was 
just too painful to emulate such a bug. 

Unsafe (Bit 12) . It never happens in CDE. 

Check Error (Bit 13). This bit is set when an unsuccessful read/write 
finish command is received, Thus, any error that UNIX encounters in 
processing a cead/write command, causes a check error. 

Data Late (Bit 14). It never happens in CDE. 

Error (Bit 15). Error <- 1 whenever any of bits 10-14 ace set oc when 
a cead/write command is issued on a not ready drive. Note, the second 
condition is not specified foe a real 4047A. The DG documentation 
doesn't define the results of such an access. 



3.0 DATA STRUCTURE 

CDE, like all other peripherals, uses the I/O table described in "The 
Design of a Nova 3 Emulator On the Stanford Emmy" , as the interface to 
the code emulator and to the CDE u-inteecupt handlers. In addition, a 
four word drive status vector not in the I/O table, is allocated to 
CDE. This vector is accessible only to CDE and maintained by the CDE 
code emulator and u-interrupt handlers. Figure 3-1 defines these 
variables and their bit assignments. 

3.1 Drive Status 

Each of the four drives owns an entry in the four word drive status 
vector (CDS) and indexes that word with its ordinal number. Complete 
status on a drive, including any outstanding UNIX I/O activity, 
resides in its status word. All status could have been compacted into 
the I/O table, nice from an overal NovaemCD point of view, but 
intolerable from and accessiblity standpoint. The current structure 
allows fast indexing of status. The CDE record in the I/O table 
cannot be increased in size to include CDS as it would prohibit the 
homogeneous treatment of I/O devices by Novaem when executing global 
Nova I/O instructions, like IORST. 

Referencing figure 3-1, bits 0-6 of the drive status word correspond 
to the drive error bits defined in section 2. Bits 16-23 define the 
current cylinder number. This field specifies the position of the 
emulated head for the drive, and is used in UNIX seek address 
calculation. The field is updated during execution of a Nova seek 
command (IOPLSE) . 

Bit 26 is the seek flag, and is set by the Nova IOPLSE command. It is 
cleared by the u-interrupt handler when the seek completes, i.e. when 
UNIX sends seek complete mail. The u-interrupt handler uses this bit 
to determine the cause of a seek command. If the seek was issued 
during execution of an IOPLSE, then the CDE seek done flag (see 
section 3.2) is set and a Nova Interrupt issued. Otherwise, caused by 
a Nova read/write command, only the drive status is updated. This 
Seek complete is only the first of two or three UNIX responses that 
must occur before the CDE Done flag can be set. 

The seeking flag is also used by the seek clear routine, P24SKAB, to 
determine if an outstanding UNIX seek command exists on the drive. If 
one does then a UNIX abort command must be generated to clear the 
seek. 

Bit 27 is the read/write flag which is currently unused. 

The no done flag, Bit 28, gets set whenever two UNIX read/write 
commands are generated during the execution of the Nova START 
function. Recall that two commands are required whenever the 
Read/write data buffer overflows, modulo 32K, through zero. When 
read/write finish mail is received from UNIX, the no done flag is 
tested. If it =1, then the CDE done flag cannot be set since another 
UNIX read/write finish response is required before the operation is 



CDSn: Q< n <3 

31 28 27 26 25 23 15 6 5 4 3 2 10 

I///I NDI//I S | ///| Cylinder | ////// 1 DR| SE.I EE I | CE | | E | 

Bits 0-6 define drive status: 

E — Ere oc . 

CE — Check error; Set when UNIX has reported a read/write error 

on this device. 
EE — End error; Set when the read/write buffer extends beyond 

the last cylinder, or an illegal sector has been specified 

in a read/write request. 
SE — Seek error. 
DR — Drive ready. 

Cylinder —Defines the current position of the emulated head. It is 
used to calculate UNIX byte addresses on a read/write 
operation. 

S — Seeking; A Seek is in progress on this drive. That is, a 
UNIX seek command, issued by the IOPLSE special function, 
hasn't completed yet. 

ND — No Done; Two read/write UNIX commands are outstanding on 
this drive. 



Drive Status Vector 
FIGURE 3-1 CDE Data Structure (page 1 of 3) 
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— Seeking flags in DIA operand. 

--Seek done flag in DIA operand. 

--Read/write done flag in DIA operand. It is a copy of D in 
IOFR. 



CYL — Cylinder field in DOA operand. 

C — Command field in DOA operand. 

MAR — Memory address cegistec. 

-SCNT --Sector count field in DIC/DOC operand. 
SECTOR — Sector # in DIC/DOC operand. 

S — Side # in DIC/DOC operand. 

DN — Selected dc ive # in DIC/DOC operand. 



IOT Record 
Figure 3-1 CDE Data Structure (page 2 of 3) 



Register TEMP contains read/write completion values foe all variables 
in Reg B and Reg C along with final status foe the selected drive. 

I — CDE Nova Interrupt; When 1=1 CDE has set IR and 
incremented ICNT. 

D — Read/write Done. 

B — Read/write Busy; When B =1 a cead oc write operation is in 
progress. 

A — Aboc t ; A=l when a UNIX aboc t (device) command is in pcogeess 
on one of the CDE devices. 

DN — Ordinal number of drive last involved in a cead oc wc ite 
opecation. 

DONEF — Nova I/O Bus done field. Bit 23 of DONEF <- 1 whenevec any 

of the seek done flags in Reg A oc the eead/wcite done flag=l 
It is cleaced when all done flags = 0. 

%£S£t Terrntr\qTi0At */a*o -for loRsT . 



IOT Recocd 
Figuce 3-1 CDE Data Stcuctuce (Page 3 of 3) 
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complete. The no done flag is cleared. Otherwise, (no Done =0) , the 
mail indicates that the data transfer is complete and that the CDE 
Done Flag should be set. In addition, the CDE busy flag is cleaced 
and a Nova Interrupt issued. 

3.2 The CDE I/O Record 

The cartridge disk device cegistecs reside in the ficst thcee words of 
CDE's I/O table record. 

Registers B, and C ace simple 16 bit bidirectional cegistecs and theic 
bit assignments ace consistent with the specification in the 
Peciphecals Refecence Manual* Bits 16-31 of these cegistecs ace unused 
and may assume any value. 

Registec A has a moce complex cepcesentation foe two ceasons: 

1) The focmat foe RegA on a DOA (output) instruction differs 
fcom that of the DIA (input) instcuction. 

2) Bits 0-6 of the DIA opec and contain the status of the 
selected drive; that delve defined in RegC. 

Foe these ceasons, the infocmation stoeed in RegA does not match the 
focmat defined by the DIA and DOA instcuctions, adding some 
complication to the DIA and DOA execution -routines. 

Bits 0-6 of Reg A ace unused. On a DIA instcuction, bits 0-6 of the 
opec and ace fetched fcom the selected dcive's status wocd. 

Bits 7-15 contain the seeking flags, the seek done flags, and the 
cead/wcite done flag. These ace used in DIA opec and focmat ion. A 
seeking flag is set by the IOPLSE execution routine . It is cleaced 
by the u-inteccupt handlecs and clear eoutines. A seek done flag is 
set by the u-inteccupt handlee when seek complete mail is received on 
a seek that was requested by the IOPLSE execution coutine. It is 
cleaced by the DOA execution coutine and the eleae eoutines. The 
cead/wcite done flag is a copy of the CDE done flag in IOFR. It is 
maintained by the Stact, u-inteccupt, and cleae eoutines. 

Bits 16-23 contain the cylindec field of the DOA opec and. It is used 
only by the IOPLSE execution unit to update the selected dcive's 
status wocd and to focm the byte addeess pacameter in the UNIX seek 
command . 

Bits 24 and 25 represent the command field of the last DOA operand, 
and ace used by the IOPLSE and START execution units. 

Reg Temp pcovides tempocacy storage eequiced by the execution of the 
START command. The START execution unit, M04CD100, calculates final 
values foe the cead/wcite vac iables contained in Regs B and C, and 
genecates final de ive status. This infocmation is stoeed in Reg Temp 
and cemains theee until the UNIX I/O completes, at which time the 
cead/wcite u-inteceupt handlee uses it to foem the final pacametecs in 
Registec s B and C, and to foem final de ive status. 



IOFR is identical to the Nova Bus status wocds of all other 
peripherals. However, there ace some unique character istics: 

1) Bits 5 and 6 of this word contain the ordinal number of 
the drive last used in a read/write command. Thus, if a 
cead/wcite operation is in progress, bits 5-13 of IOFR will 
define the UNIX device number involved. This infomation is 
used by the read/write clear procedure, P21RWC, to abort a 
data transfer operation. 

2) Unlike all other peripherals, a Nova interrupt request 
(bit 23=1) may be pending, even though done =0. This is so 
because the done flag in CDE represents only read/write done 
status. There are, in addition, the four seek done flags 
found in RegA. An interrupt request is generated whenever 
any of the seek or read/write done flags =1, and the request 
cleared only when they all =0. 

The last word in CDE ' s record is a pointer to the CDE power on reset 
procedure, M04CDCL, to be used by the IORST execution routine when 
intializing CDE. 



4.0 ROUTINES 

Table 4-1 lists all routines used to implement the CDE interface. Like 
other devices, the cartridge disk I/O instructions ace parsed in two 
steps. 

1) The opcode field is decoded and all cegistec transfers 
performed. 

2) If the opcode did not specifiy a skip, then the special 
function field is decoded to determine what I/O, if any, is 
to be performed. If the opcode specifies a skip, an exit to 
the global skip routine, M04SKP, occurs. 

The CDE u-interrupt handlers (1127) , process all UNlX-to-Emmy mail 
directed to the disk drives, devices O'330' — 0'333'. 

CDE was designed with readability and reliability as the Key design 
goals. Speed was hardly a consideration because the I/O instructions 
should be executed relatively infrequently. Since CDE was designed to 
incomplete documentation, some functional changes will probably be 
required before a disk based operating system can be reliably 
supported. Therefore, it is essential that CDE be well structured and 
easy to understand. The author sincerely hopes that CPE has met its 
design goals. 

CDE uses 455 words of control store. This includes the CDE execution 
routines and u-interrupt Handlers. 
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NAME 



M04CDS 
M04CD20 — 70 
M04CD10 
M04CD100 

M04CD200 

M04CD300 

M04CDCL 

M0 4CDNR 
M04CDEE 
M04CDSE 

I127CDS 



ROUTINES 

DESCRIPTION 



CDE instruction decode routine. 

DIA-DOC instruction execution routines. 

CDE special function decode routine. 

START special function execution routine; initiates 
UNIX read/write and seek commands. 

CLEAR special function execution routine, issues 
UNIX abor t (device) command. 

IOPLSE special function execution routine; 
initiates UNIX seek command. 

CDE clear procedure used by P04IORST. 

Error exit routines used by M04CD100-300 . 



CDE u-interrupt handlers. 



Table 4-1. CDE Routines and Procedures. 
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NAME 



P21RWC 

P22ICL 

P23MUL 
P24SKAB 

P25SKD 
P25RWD 



PROCEDURES 

DESCRIPTION 



Clears any read/write command cue cent ly in 
execution on UNIX. 

Removes the CDE interrupt request from the Nova 
I/O Bus. 

32 bit multiply routine 

Clears the specified drive's status wocd and 
aborts all UNIX I/O on the device. Issues 
UNIX abort (device) command. 

Sets the specified seek done flag and issues 
a Nova interrupt. 

Sets the cead/wcite done flag and issues a 
Nova Interrupt. 



Table 4-1. CDE Routines and Procedures - Continued 
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5.0 STATUS OF THE PROJECT 

Unfor tunately, time did not allow adequate verification of the storage 
system. The NovaemCD Emulator, however, contains the complete CDE 
device and interrupt routines, and simple Nova I/O programs have been 
run to vecify at least functional integrity. 

Because CDE cannot perform real time emulation of the 4047A, Nova disk 
diagnostic programs will probably not be usable, This is only 
conjecture, however, as no attempt has been made to run such programs. 
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6.0 CONCLUSIONS 

CDE turned out to be a very difficult program to develop, largely due 
to the complexity of the 4047 hardware interface. It is clear that 
the 4047A evolved under sevece hardware and compatability constraints 
resulting in a very unstructured and difficult to document interface. 

90% of the 4047A function could have been emulated with a much simpler 
program. However , the value of such an emulator is questionable since 
the disk driver in the operating system will have to be rewritten to 
compensate foe the other 10% of the function. But, if driver rewrite 
is required, then a single disk I/O emulation package encompassing 
both the driver and the disk system is a better solution. The new 
driver for this system would contain a single currently undefined Nova 
instruction which is recognized by the Emmy code emulator as a request 
to execute the I/O emulator. Thus, the emulation interface resides at 
the I/O driver call level instead of at the hardware level. But, this 
level of interface, in a typical minicomputer operating system, is 
even less well defined and documented, and may indeed be more complex, 
requiring the emulator writer to have intimate knowledge of the 
operating system primitives. 

CDE attempts to perform non real time class A emulation of the 
hardware interface with the goal of supporting any DG 4047A driver. If 
sucessful, then any of Data General's commercial systems can be easily 
installed on NovaemCD. 



APPENDIX A. INSTALLING A NOVA I/O HANDLER ON NOVAEMU OR NOVAEMCD 

Installing a new I/O emulator and Novaem is a well defined task and 
requires only minor modification to the current code emulator . The new 
device will contain two programs; the device code emulator, and the 
u-interrupt handler. 

To install the device, the following modifications to Novaem must be 
made: 

1) The starting address of the code emulator must be entered in 
the device code jump tables at M01IO and at I100UNIX. Its 
location, in the tables, is determined by its device code. 

2) An I/O record must be created for the device in the I/O table 
(IOT) . Its location in this table is arbitrary but must follow 
IOTZERO and precede IOTCPU. The location determines its priority 
on the emulated I/O Bus. 

The I/O record must be six words in length. The first four are 
totally specified by te I/O Emulator design. The fifth word 
"IOFR" must adhere to the format defined in "The Design of a Nova 
3 Emulator on The Stanford Emmy" since it is used by the the 
global I/O instructions. The sixth word must contain the address 
of the new device's reset routine. If the device has a simple 
I/O structure, then procedure P04CL can be used. 

3) The number of devices variable, NUMJDF_DEV, must be 
incremented to reflect the new entry, 

4) Declarations defining the device code and mask should be 
entered in the I/O device construction table. 

The designer must strictly adhere to the busy/done protocols defined 
for the emulated Nova I/O Bus. If the device is simple, then he may 
use P01CLEAR and P02DONE to assist in the management of the busy, 
done, and interrupt flags. 



REFERENCES 



1) GENACC Program Listing 

Digital Systems Lab, Stanford Electronics Lab 
Stanford University, March 1978 

2) Chacles Neuhauser 

"An Emmy Based PDP11/20 Emulation" 

Digital Systems Lab, Stanford Electronics Lab 

Stanford University, March 1977 

3) Charles Neuhausec 

"Emmy System Processor — Principles of Operation" 
Digital Systems Lab, Stanford Electronics Lab 
Stanford University, May 1977 

4) Lee W. Hoevel 

"Deltcan: Principles of Operation. A directly Executed 

Language For Fortran II" 

Digital Systems Lab, Dept, of Electrical Engineering and Computer 

Science 

Stanford University, March 1977 

5) Digital Equipment Corp 
"PDP11/03 Processor Handbook" 
Copyright 1975 

6) Data General Corporation 

"Programmer 's Reference Manual — Nova Line Computers" 
Doc # 015-000023-04 
Copyright August 1976 

7) Data General Corporation 

"Programmer's Reference Manual — Peripherals" 
Doc # 015-000021-00 Rev. 00 
Copyright November 1974 



8) Data General Corporation 
"Exerciser foe NOVA 3" 
Doc # 096-000363-02 
Copyright 1976 



n 



